home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / bbs / nn12.zip / NN.DOC < prev    next >
Text File  |  1992-11-08  |  9KB  |  301 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.      ██████  ██                  ██
  15.     ▓██▓▓██ ▓██                 ▓██
  16.     ▓██ ▓██ ▓██  ████████  ████████  ████████
  17.     ▓██ ▓██ ▓██ ▓██▓▓▓▓██ ▓██▓▓▓▓██ ▓██▓▓▓▓██
  18.     ▓██ ▓██ ▓██ ▓██   ▓██ ▓██   ▓██ ▓██   ▓██
  19.     ▓██ ▓██ ▓██ ▓██   ▓██ ▓██   ▓██ ▓████████
  20.     ▓██ ▓██ ▓██ ▓██   ▓██ ▓██   ▓██ ▓██▓▓▓▓▓
  21.     ▓██ ▓██ ▓██ ▓██   ▓██ ▓██   ▓██ ▓██
  22.     ▓██ ▓██████ ▓████████ ▓████████ ▓████████           Fido Net Node List/Diff
  23.     ▓▓  ▓▓▓▓▓▓  ▓▓▓▓▓▓▓▓  ▓▓▓▓▓▓▓▓  ▓▓▓▓▓▓▓▓            and FidoNews Utility. 
  24.  
  25.  
  26.  
  27.      ██████  ██
  28.     ▓██▓▓██ ▓██
  29.     ▓██ ▓██ ▓██  ████████  ██        ██  ████████       Created by Tom Carroll
  30.     ▓██ ▓██ ▓██ ▓██▓▓▓▓██ ▓██   ██  ▓██ ▓██▓▓▓▓▓        Copyright (C) 1992
  31.     ▓██ ▓██ ▓██ ▓██   ▓██ ▓██  ▓██  ▓██ ▓██             All rights reserved
  32.     ▓██ ▓██ ▓██ ▓████████ ▓██  ▓██  ▓██ ▓████████
  33.     ▓██ ▓██ ▓██ ▓██▓▓▓▓▓  ▓██  ▓██  ▓██ ▓▓▓▓▓▓▓██
  34.     ▓██ ▓██ ▓██ ▓██       ▓██  ▓██  ▓██        ██
  35.     ▓██ ▓██████ ▓████████ ▓████████████ ▓████████
  36.     ▓▓  ▓▓▓▓▓▓  ▓▓▓▓▓▓▓▓  ▓▓▓▓▓▓▓▓▓▓▓▓  ▓▓▓▓▓▓▓▓        Version 1.2   11-08-92
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.                                  The Data Shop BBS
  56.                                 (509)582-9493 (HST)
  57.                                    Kennewick, WA
  58.                               FIDO address (1:347/10)
  59.  
  60.                              MAGIC FILE NAME: NODENEWS
  61.     ┌──────────────┐
  62.     │ INTRODUCTION │
  63.     └──────────────┘
  64.  
  65.     I wrote Node/News because I got tired of my BBS hanging in an endless loop
  66.     every time I received a NODExxxx file, or the Fido News.  I had a batch file
  67.     routine setup to copy the files, and process them into the BBS, but then I
  68.     wrote Node/News, and I couldn't delete the files like I was doing before.
  69.     This utility is a last ditch effort for me, before I sit down and really
  70.     learn how to write efficient batch routines.  <grin>
  71.  
  72.     ┌──────────────┐
  73.     │  DISCLAIMER  │
  74.     └──────────────┘
  75.  
  76.     This software is provided without any guarantee or warranty either expressed
  77.     or implied.  I will not be held responsible for ANY damages that may result
  78.     in the use of this program.  "ANY" means if you install it, run it, and it
  79.     eats your programs that you've been working on for 2 years without a backup,
  80.     IT'S NOT MY FAULT!!!
  81.  
  82.     Node/News software and this document are Copyright (C) 1992 by Tom Carroll. 
  83.     All rights reserved.
  84.  
  85.     ┌──────────────┐
  86.     │   LICENSE    │
  87.     └──────────────┘
  88.  
  89.     This program is being released as FREEWARE.  The source code will remain
  90.     the property of the author unless otherwise released by him.
  91.  
  92.     You are free to use this version of the program without any cost of
  93.     registration.  This however, may change at any time with a new version
  94.     release. (If this should happen, a one time registration fee will be asked)
  95.  
  96.     No one may alter, modify, or reverse engineer Node/News for any reason,
  97.     including but not limited to decompiling-compiling, patching, or
  98.     disassembling.
  99.  
  100.     You may freely distribute & copy this program for others subject to the
  101.     above restrictions and the following:
  102.  
  103.          ■ Node/News is copied in unmodified form including this file. 
  104.          ■ There is no charge for copying except for the cost of disks.
  105.          ■ Node/News is not included in another software package
  106.            without the express written permission of Tom Carroll
  107.  
  108.     ┌──────────────┐
  109.     │   SUPPORT    │
  110.     └──────────────┘
  111.  
  112.     If you should find any problems with this program, or you have any requests
  113.     or recommendations, you may reach me on my BBS, or at the FIDO address
  114.     listed on the front cover.  I may also be reached in the QUIK_BAS & PCBNET
  115.     FIDO echos.
  116.  
  117.  
  118.  
  119.     
  120.     Node/News v1.2                                                       Page 2
  121.     ┌──────────────┐
  122.     │  THE AUTHOR  │
  123.     └──────────────┘
  124.  
  125.     This is my second public program.  I'm planning on more, so keep your eyes
  126.     peeled!
  127.  
  128.     I have been writing in BASIC for about 7 years, and I really like it, but 
  129.     I'm planning on taking a course in "C" this fall, so this might be my last 
  130.     summer programming in BASIC.
  131.  
  132.     I am presently active duty in the U.S. Coast Guard, and have been a "Sysop"
  133.     for their computer systems at my duty stations for about 6 years.
  134.  
  135.     I would like to thank my wife, who always says "Are you coming to bed, or
  136.     are you going to keep PLAYING on that computer?"
  137.  
  138.     ┌──────────────┐
  139.     │    FILES     │
  140.     └──────────────┘
  141.  
  142.     Files included in this archive:
  143.  
  144.                 NN.DOC - This manual
  145.                 NN.EXE - Node/News Executable
  146.                 NN.HIS - Node/News history file
  147.            FILE_ID.DIZ - Description file for Node/News
  148.           PAGEKILL.EXE - A little utility I wrote for FIDONEWS
  149.  
  150.     I originally compressed this program as NNnn.ARJ, but it may be
  151.     compressed with any other archiving program you wish to use.
  152.  
  153.     The latest version will always be available on my BBS using the magic
  154.     filename of NODENEWS.
  155.     
  156.     ┌──────────────┐
  157.     │    SETUP     │
  158.     └──────────────┘
  159.  
  160.     All you need to do is type NN <enter> to get the help screen.
  161.  
  162.     Here is an example of the help screen:
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.     Node/News v1.2                                                       Page 3
  181.  
  182.     Node/News, FIDO NEt's NODE list/diff file & FIDONEWS processor.  Version 1.1
  183.     Copyright (C) 1992 by Tom Carroll, All rights reserved               8-11-92
  184.  
  185.     USAGE:  To check for a new NODELIST, NODEDIFF, or FIDONEWS file that is 
  186.     newer than the last one processed.  It will store all info within the 
  187.     NN.DAT file in order to compare the file date-time stamp to the last one
  188.     processed.  NN will only work with one file type at a time.  In order to
  189.     check for the existence of all three, you need to make three separate calls
  190.     to NN.EXE
  191.  
  192.     SYNTAX:  NN <LIST/DIFF/NEWS> <DIR>|N
  193.  
  194.     LIST will check for a new NODELIST.xxx
  195.     DIFF will check for a new NODEDIFF.xxx
  196.     NEWS will check for a new FNEWS*.xxx
  197.  
  198.     DIR is the location of your inbound files directory in the format of
  199.     C:\FD\FILES (without the trailing back slash)
  200.     
  201.     NN will exit with the following error levels:
  202.      0 = No files to process
  203.      1 = File exists, but isn't new
  204.      2 = File exists, and it's newer
  205.      3 = NN internal error, unsuccessful execution
  206.  
  207.     There will be one log file created if it doesn't exist called NN.DAT.
  208.     This file keeps information for the three files so it can compare the 
  209.     file date / time stamp and exit with the appropriate error level.  This
  210.     file should never grow larger than 72 bytes.
  211.  
  212.     Here is an excerpt of my RUN.BAT file which shows how I process my files:
  213.  
  214.     CD \PCB\FD
  215.     REM           ---------  CHECK FOR NEW NODE & FIDO NEWS FILES    ---------
  216.     NN DIFF C:\FD_FILES
  217.     IF ERRORLEVEL 2 GOTO NODEDIFF N
  218.     NN LIST C:\FD_FILES
  219.     IF ERRORLEVEL 2 GOTO NODELIST N
  220.     NN NEWS C:\FD_FILES
  221.     IF ERRORLEVEL 2 GOTO FIDONEWS N
  222.     FD
  223.  
  224.     REM           --------- APPLY THE NEW NODEDIFF TO THE NODELIST  ---------
  225.     :NODEDIFF
  226.     CLS
  227.     ECHO          *********        PROCESSING NODEDIFF FILE         *********
  228.     CD \FD_NODE
  229.     PKUNPAK -E \FD_FILES\NODEDIFF.*
  230.     XLAXDIFF /C
  231.     CD \PCB\FD
  232.     FDNC /F
  233.     GOTO RESUME
  234.     
  235.  
  236.  
  237.  
  238.  
  239.  
  240.     Node/News v1.2                                                       Page 4
  241.     
  242.     REM           ---------        COMPILE THE NEW NODELIST         ---------
  243.     :NODELIST
  244.     CLS
  245.     ECHO          *********        PROCESSING NODELIST FILE         *********
  246.     CD \FD_NODE
  247.     DEL NODELIST.*
  248.     PKUNPAK -E \FD_FILES\NODELIST.*
  249.     CD \PCB\FD
  250.     FDNC /F
  251.     GOTO RESUME
  252.     :FIDONEWS
  253.     REM           ---------  PROCESS THE LATEST FIDO NEWS INTO BLT  ---------
  254.     CLS
  255.     ECHO          *********       PROCESSING FIDO NEWS FILE         *********
  256.     CD \PCB\GEN
  257.     LHA E \FD_FILES\FNEWS*
  258.     PAGEKILL *.NWS
  259.     COPY *.NWS BLT15
  260.     DEL *.NWS
  261.     CD \PCB\FD
  262.     GOTO RESUME
  263.  
  264.     
  265.     
  266.     That's it, you shouldn't have to do anything else, but fire it up!
  267.  
  268.     Thanks, and enjoy...
  269.  
  270.  
  271.  
  272.  
  273.  
  274.     
  275.     
  276.     
  277.     
  278.     
  279.     
  280.     
  281.     
  282.     
  283.     
  284.     
  285.     
  286.     
  287.     
  288.     
  289.     
  290.     
  291.     
  292.     
  293.     
  294.     
  295.     
  296.     
  297.     
  298.     
  299.     
  300.     Node/News v1.2                                                       Page 5
  301.